Contexto global

FindFilesAsync

Sintaxis:

FindFilesAsync(<Ruta>, <Máscara>, <BuscarEnSubdirectorios>)

Parámetros:

Tipo: Cadena.
Ruta al directorio donde se realiza la búsqueda. El directorio puede estar ubicado tanto en LAN como en un servidor FTP. Al utilizar este esquema, especifique barras diagonales (/) en lugar de barras invertidas (\) en las direcciones.
Se permite especificar el nombre completo del archivo (ruta + nombre).

Tipo: Cadena.
Máscara de selección de archivos.
Si se especifica el parámetro, el primer parámetro se interpreta como la ruta al directorio donde se buscarán los archivos que coincidan con la máscara de selección.
Para Microsoft Windows:
La máscara puede incluir los siguientes caracteres comodín: * (cualquier número de cualquier carácter) y ? (cualquier carácter).
Ejemplos de cadenas:

Para sistemas operativos Linux, macOS, iOS y Android:
La máscara puede incluir los siguientes caracteres y comodines:

• Cualquier carácter permitido en los nombres de archivo. Los caracteres especificados se asignan:
  • Para Linux y macOS, con distinción entre mayúsculas y minúsculas.
  • Para iOS y Android, sin distinción entre mayúsculas y minúsculas.
• * (cualquier número de cualquier carácter)
• ? (cualquier carácter)
• [ (una clase de caracteres). Especifique una secuencia de caracteres después del corchete de apertura. Cualquiera de estos caracteres coincide con la plantilla. Puede especificar un rango de caracteres usando un guión (-). Un corchete de cierre (]) designa el final de la clase de caracteres. Para incluir un guión en el conjunto de caracteres, especifíquelo en la primera o última posición. Un signo de exclamación (!) después del corchete de apertura especifica que todos los caracteres excepto los enumerados coinciden con el filtro.

Ejemplo de cadena:

Tipo: Booleano.
Verdadero. Se iterarán los directorios adjuntos al parámetro <Ruta>. La búsqueda se realizará en estos directorios.
El parámetro se ignora si no se especifica el parámetro <Máscara>, ya que se supone que se busca un solo archivo.
Valor predeterminado: Falso.

Valor devuelto:

Tipo: Promise.
El resultado de la ejecución de la promesa es una matriz de objetos File que contiene todos los archivos encontrados.

Descripción:

Función asíncrona. Realiza una búsqueda por la máscara especificada de archivos y directorios ubicados en el directorio especificado.

Disponibilidad:

Cliente ligero, cliente web, cliente móvil, servidor, cliente grueso, conexión externa, aplicación móvil (cliente), aplicación móvil (servidor), servidor independiente móvil.

Nota:

Todos los objetos a buscar deben estar ubicados en un solo directorio.
Este método requiere la instalación de la extensión del sistema de archivos para funcionar en el cliente web.

Véase también:

Contexto global, método BeginFindingFiles
Contexto global, método FindFiles

Disponible desde:

Disponible desde la versión 8.3.18.